package com.tencent.wxcloudrun.mapper;

import java.util.List;

import org.apache.ibatis.annotations.Param;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.tencent.wxcloudrun.domain.TUserCard;
import com.tencent.wxcloudrun.dto.StoreCardQueryCountResDTO;
import com.tencent.wxcloudrun.dto.UserCardListResDTO;
import com.tencent.wxcloudrun.vo.response.card.StoreCardQueryUserCountResVo;

/**
 * @author ziyin.zhao
 * @description 针对表【t_user_card(用户卡片表)】的数据库操作Mapper
 * @createDate 2025-04-22 16:43:56
 * @Entity com.tencent.wxcloudrun.domain.TUserCard
 */
public interface TUserCardMapper extends BaseMapper<TUserCard> {

    /**
     * 根据用户ID查询用户卡片数量
     *
     * @param userId 用户ID
     * @param cardId 卡片ID
     * @return 用户卡片查询出参实体
     */
    List<UserCardListResDTO> listCard(@Param("userId") Long userId, @Param("cardId") Long cardId);

    /**
     * 查询总数
     *
     * @return 卡片总数列表
     */
    List<StoreCardQueryCountResDTO> queryCount();

    /**
     * 查询用户总数
     *
     * @param page 分页参数
     * @param cardId 卡片ID
     * @param userIdList 用户ID列表
     * @return 卡片总数列表
     */
    List<StoreCardQueryUserCountResVo> queryUserCount(Page<StoreCardQueryUserCountResVo> page,
        @Param("cardId") Long cardId, @Param("userIdList") List<Long> userIdList);

}
